home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / fm2_252.zip / read.me < prev    next >
Text File  |  1997-03-04  |  19KB  |  392 lines
  1.  ┌──────────────────────────────────────────────────────────────────────────┐
  2.  │F(ile) M(anager)/2 copyright (c) 1993-97 by M. Kimes  (Barebones Software)│
  3.  │                            All Rights Reserved                           │
  4.  ├──────────────────────────────────────────────────────────────────────────┤
  5.  │                READ.ME file -- read before installing                    │
  6.  │        See end of document for contact info and license details          │
  7.  └──────────────────────────────────────────────────────────────────────────┘
  8.  
  9.  
  10. File Manager/2 (FM/2) is a shareware OS/2 3.0 (Warp)+ PM 32-bit
  11. file/directory/archive maintenance utility (a sort of super-Drives
  12. object, something midway between the Drives objects and a more
  13. traditional file manager) with plenty of bells, whistles and utilities,
  14. drag and drop, context menus, toolbars and accelerator keys.  If you
  15. know how to use OS/2, you already know how to use most of FM/2.  You can
  16. easily glean the rest from the extensive online help, including
  17. tutorials.
  18.  
  19. This document explains how to install FM/2, including upgrading from
  20. previous versions.  It explains command line syntaxes and how to get the
  21. program(s) running.  The online help tells you how to actually use FM/2.
  22. A separate document (history.txt) lists changes for this version.
  23. Another (register.txt) tells you how to register FM/2.  If you're
  24. interested, there're well over 110 printed pages of documentation in
  25. this package, counting only this file and the online help -- did I write
  26. all that?
  27.  
  28. The license agreement and author contact info is at the bottom of the
  29. file.
  30.  
  31.  
  32. FM/2 2.x installation instructions:
  33. ==================================
  34.  
  35.    1. Unpack the FM2*.ZIP archive in a private directory (UNZIP.EXE
  36.       works nicely).  FM/2 2.x requires its own home directory (FAT or
  37.       HPFS, doesn't matter). I recommend that it _not_ be your old FM/2
  38.       1.x directory (and don't delete the old 1.x version until after
  39.       you install, so the install program can migrate some of your old
  40.       settings and registration first).  If upgrading from 2.x, just
  41.       unpack the files in the FM/2 2.x directory and go (be sure to
  42.       overwrite old files -- you might want to skip ARCHIVER.BB2 if
  43.       you've customized it).  Note:  don't attempt to unpack using FM/2
  44.       into the directory in which FM/2 is already running -- OS/2 locks
  45.       in-use files and the upgrade won't be completed properly; not all
  46.       files will be unpacked.
  47.  
  48.   2.  Run the provided INSTALL.CMD (a simple REXX program) in that
  49.       directory to build a folder and program objects and migrate some
  50.       old INI information.  Rerun INSTALL.CMD if you later move the FM/2
  51.       directory.  (If you later decide to remove FM/2, run UNINSTAL.CMD
  52.       in the FM/2 2.x directory and follow simple directions.  Both
  53.       installation and deinstallation are no-brainers.  UNINSTAL will
  54.       help you quickly and easily remove all traces of FM/2 from your
  55.       system if you don't like it for some reason.  All OS/2 programs
  56.       should be so nice.)  INSTALL sets up some associations for you
  57.       unless you give it /NOASSOC as an argument (INSTALL /? for help).
  58.  
  59.   3.  Run it -- double-click the "FM/2" or "FM/2 Lite" object in the
  60.       File Manager/2 folder.  Have fun.  Full help is available from
  61.       within the program.  If you're unfamiliar with OS/2's WPS, please
  62.       take the time to run the OS/2 Tutorial before attempting to use
  63.       FM/2, as FM/2 uses many of the same conventions.  It'll save you
  64.       time in the long run.
  65.  
  66.   4.  If you'd like to review all the documentation on FM/2 before
  67.       running it, you can.  Unpack FM3.HLP from the archive, then type
  68.       VIEW FM3.HLP.
  69.  
  70.  
  71. Starting FM/2:
  72. =============
  73.  
  74. If you start File Manager/2 (filename FM3.EXE) with no command line
  75. arguments, it opens the Drive Tree window but no directory windows
  76. (unless the "Save state of dir windows" toggle is checked -- see online
  77. help).
  78.  
  79. File Manager/2 optionally accepts names of directories on the command
  80. line; it'll open a directory window for each one.  Hint:  If you often
  81. do different specific things with FM/2, you might set up a WPS object
  82. customized to start up ideally for each activity.  For example, if you
  83. wanted to maintain your BBS areas, you might have one object like:
  84. "FM3.EXE D:\BBSDIR D:\BBSDIR\MAILIN D:\BBSDIR\MAILOUT", and if you also
  85. like to use FM/2 to set icons on files, you might have another object
  86. like:  "FM3.EXE E:\MYICONS D:\NEWFILES".  The State userlist can also be
  87. used for this within FM/2 itself -- see online help.
  88.  
  89. You can exclude drives on the command line by prefacing the drive letter
  90. with "/", and there can be more than one drive letter behind the "/"
  91. (i.e. "FM3.EXE /BH" to exclude both drives B: and H:).  Hint:  Many
  92. people like to use /B to exclude "phantom" drive B: if they have a
  93. single-floppy system.  Similarly, you can cause drives NOT to be
  94. prescanned by the Drive Tree by prefacing the drive letter with ";",
  95. drives NOT to load icons for objects by prefacing the drive letter with
  96. ",", drives NOT to load subjects for objects by prefacing the drive
  97. letter with "`" and drives NOT to load longnames for objects by
  98. prefacing the drive letter with "'".  This can be handy if you have a
  99. very slow drive like a CD-ROM or Zip drive.  FM/2 Lite recognizes
  100. these switches, too.  See also the Drive Flags dialog in FM/2.
  101.  
  102. If you place the argument "+" (alone) on the command line, FM/2 will
  103. log, to FM2.LOG, delete, rename, move and copy operations that are
  104. performed by drag-and-drop or with the menus.  FM/2 Lite recognizes this
  105. switch, too.
  106.  
  107. The command line argument "-" (alone) causes FM/2 to ignore, not load or
  108. save, the previous state of directory windows (see the "Save state of
  109. dir windows" toggle under Config Menu->Toggles in the online help) for
  110. that invocation.
  111.  
  112. You can specify the name of an alternate INI file with "-<inifilename>"
  113. -- for example, "FM3.EXE -C:\FM2\MYINI.INI".
  114.  
  115.  
  116. Installation notes:
  117. ==================
  118.  
  119. Please read the following sections in the online help when you start
  120. FM/2 for the first time:  "How to use FM/2's Help," "Terminology" and
  121. "General Help," then "Hints."  The rest you can browse as you get
  122. time/feel the need; for instance, if you want to know what a toggle
  123. does, read the help under Settings notebook for that page (each
  124. Settings notebook page has its own Help button).
  125.  
  126. If you prefer hardcopy help, print this file, run FM/2, press Ctrl + F1,
  127. click the "Print" button at the bottom of the help window that appears
  128. and then print both the "Contents" and "All sections" (keep an eye on
  129. the printer, after page 100 of "All sections" as the Help Manager will
  130. begin printing its own help then -- you may want to abort printing at
  131. that point).  Advanced and/or curious users may also want to print
  132. FM3TOOLS.DAT and ARCHIVER.BB2.  Be sure you have plenty of paper and ink
  133. handy -- the package is well documented.  You'll probably also want a
  134. three-ring binder and hole punch to get it bound, as staples aren't
  135. going through that puppy.  You can, of course, print only the sections
  136. that are of particular interest to you.
  137.  
  138. You may want to either move ARCHIVER.BB2 (the data file containing
  139. information about archiver programs and archive files) to a directory in
  140. your PATH= statement or erase this one if you've customized an old one.
  141. FM/2 can still find, use and maintain ARCHIVER.BB2 on the PATH; it
  142. doesn't have to be in FM/2's directory (this allows it to be used by
  143. other programs as well, like XGroup, XBBS/2, LA, AV, ZTreeBold, etc.).
  144. Remember, FM/2 works best with OS/2, not DOS, archivers.
  145.  
  146. If FM/2 refuses to run, the most likely culprit is CONFIG.SYS.  Your
  147. LIBPATH statement should contain "." or ".\" (shorthand for "the default
  148. directory"), as in:  LIBPATH=.;C:\OS2\DLL;C:\OS2\MDOS;<etc.>  This is
  149. the default OS/2 installation, but a few folks, or programs they've
  150. installed, have changed it.
  151.  
  152. I've separated many of the standalone utilities that I used to include
  153. with FM/2 into another archive (FM2UTILS.ZIP, or FM2UTL.ZIP on CIS).
  154. Since I update the utilties far less frequently than FM/2 itself, this
  155. allows you to download less and still keep up to date.  To get the
  156. maximum use out of FM/2, you should pick up the package.  If you can't
  157. find it where you found this archive, bug your sysop to pick it up.
  158.  
  159.  
  160. Bonus programs:
  161. --------------
  162.  
  163. You'll note the extra objects that the Install program creates in the
  164. File Manager/2 folder.  FM/2 is modular, so that you can get directly to
  165. some of its components without running the entire ball of wax.  This may
  166. allow you to enhance the behavior of some of your other applications in
  167. the WPS tradition.  You don't _have_ to keep these around, of course --
  168. FM/2 itself contains all their functionality.
  169.  
  170.   Archive Viewer/2:   Intended for drag-and-drop operation (or WPS
  171.                       association) with WPS objects or other
  172.                       applications.  Drag an archive onto it, drop it,
  173.                       get an archive listing box.  FM/2's installation
  174.                       program sets up some associations between archive
  175.                       files and this program by file extension (run
  176.                       INSTALL with "NOASSOC" as an argument if you don't
  177.                       want them).  AV/2 will try to display whatever
  178.                       you give it as sensibly as it can.  Filename AV2.EXE.
  179.  
  180.   EA Viewer:          Drag a file system object onto it and it'll show
  181.                       you the object's extended attributes.  Filename
  182.                       EAS.EXE.
  183.  
  184.   INI Viewer:         Drag an .INI file onto it and it'll show you its
  185.                       contents.  Filename INI.EXE.
  186.  
  187.   Bookshelf Viewer:   Shows all .INF files in a listbox and lets you
  188.                       pick the one(s) you want to view.  If you give any
  189.                       command line argument, the .HLP files on the HELP
  190.                       path will be shown instead (the Helpfile Viewer
  191.                       object calls VIEWINFS.EXE with "dummy" for an
  192.                       argument, for example).  Filename VIEWINFS.EXE.
  193.  
  194.   Process Killer:     Lets you kill off renegade processes.  An English
  195.                       version of PSTAT.EXE must be on your PATH.
  196.                       Filename KILLPROC.EXE.
  197.  
  198.   Undeleter:          Lets you undelete files (via interface with
  199.                       UNDELETE.COM).  Drag a file system object onto it
  200.                       and it'll let you undelete files for that drive.
  201.                       Filename UNDEL.EXE.
  202.  
  203.   Visual Tree:        Opens a Drive Tree window (like the WPS Drives
  204.                       object with more horsepower).  Filename VTREE.EXE.
  205.  
  206.   Visual Directory:   Opens a Directory Container window; drag a file
  207.                       system object onto it and this will open its
  208.                       directory (like a WPS directory Folder with more
  209.                       horsepower).  Filename VDIR.EXE.
  210.  
  211.   Collector:          Opens a Collector window.  Filename VCOLLECT.EXE.
  212.                       Two other objects, "See all files" and "Seek and
  213.                       scan" are created which call up the Collector and
  214.                       go directly to dialogs for the appropriate
  215.                       purpose.
  216.  
  217.   Global Viewer:      Opens a global view of a drive or drives.  Filename
  218.                       GLOBAL.EXE.
  219.  
  220.   Databar:            Opens a databar showing some system information.
  221.                       Filename DATABAR.EXE.
  222.  
  223.   SysInfo:            Shows information about your system.  Filename
  224.                       SYSINFO.EXE.
  225.  
  226.   DirSize:            Shows where drive usage is concentrated.  Filename
  227.                       DIRSIZE.EXE.
  228.  
  229.   MakeArc:            Puts whatever's dropped on it into an archive.
  230.                       Filename MAKEARC.EXE.
  231.  
  232.   FM/2 Lite:          A simplified interface for dummies.  Filename
  233.                       FM4.EXE.
  234.  
  235. FM/2's install creates FM2.CMD, AV2.CMD, VDIR.CMD, VTREE.CMD,
  236. VCOLLECT.CMD, UNDEL.CMD, KILLPROC.CMD, INI.CMD, EAS.CMD, DIRSIZE.CMD,
  237. VIEWINFS.CMD and VIEWHELP.CMD files for you in a directory
  238. "utils" off the install directory.  You should add this directory to
  239. your PATH= statement in CONFIG.SYS (type HELP PATH at a command line for
  240. more info).  If you prefer, FM/2's INSTALL builds a SETENV.CMD in the
  241. FM/2 directory which you can call to set the PATH for FM/2 in any given
  242. session without modifying CONFIG.SYS.
  243.  
  244. You will probably want to find a copy of the FM/2 Utilities (FM2UTL.ZIP
  245. on CI$, FM2UTILS.ZIP on the internet).  This archive of free-for-the-using
  246. utilities contains a few used by FM/2 "out-of-the-box":  FM2PLAY.EXE for
  247. playing multimedia files (WAV, MID, AVI, etc.), IMAGE.EXE for quickly
  248. displaying image files, disk optimizers, etc.  You can always plug in
  249. your own favorites for these, of course, using FM/2's Associations.
  250.  
  251.  
  252. Additional documentation:
  253. ========================
  254.  
  255.   Register.txt:   How to register FM/2.
  256.  
  257.  
  258. FM/2 isn't free, it's shareware:
  259. ===============================
  260.  
  261. To register FM/2, fill out REGISTER.TXT and send to the address listed
  262. in it, together with the purchase price or credit card information
  263. (commercial users, there's a 5% discount for each ten commercial
  264. licenses, up to one hundred licenses, where the price flattens, so you
  265. get a total 50% discount on each license for one hundred or more
  266. licenses in one order -- see REGISTER.TXT for a table).  Registration
  267. gets rid of the initial about box and closing screen, eases your
  268. conscience and makes the world safe for truth, justice, the democratic
  269. way and further FM/2 updates, not necessarily in that order.  I also
  270. include some things that might be useful with FM/2 if you order the
  271. disks.
  272.  
  273. Registrations are good for one year or one full version change (i.e.
  274. 2.00 -> 3.01), whichever comes last.  Versions before a full version
  275. change stay registered forever.  Considering the price, the program and
  276. the upgrade policy, I don't think you can beat FM/2 with a stick.  But
  277. then, I'm a prejudiced jerk.
  278.  
  279. (Someone asked me why registrations are cheaper for personal use than
  280.  for commercial use.  I thought it was obvious, but I guess it's not.  I
  281.  feel that individual, private use of software should be cheaper than
  282.  use in an environment where it's contributing to making money.  I feel
  283.  that much software is already priced far too high for individual,
  284.  private users as it is, and therefore I give individual, private users
  285.  a break (commercial users can get price breaks based on quantity -- see
  286.  REGISTER.TXT).  It just seems fair to me, and I've got to live with
  287.  myself.)
  288.  
  289. You can also register FM/2 at the OS/2 Supersite (os2ss.com), or you can
  290. register online via Compuserve's Shareware Registration service (GO
  291. SWREG) as #2859 for personal registrations or #4228 for commercial. The
  292. price is a bit higher on CIS to give CIS a cut (CIS will show it to you
  293. first).  Support is currently being provided in the CIS OS/2 Shareware
  294. forum (GO OS2SHARE, library 18 of OS2BVEN).
  295.  
  296. Speaking of updates, I tend to put them up _very_ regularly
  297. (incrementing the version number by .01 each time, with occassional
  298. letter increments between).  I'm one of those fellows who likes to
  299. always have some new software to play with, so I figure others might,
  300. too.  Besides, it's fun.  And finally, FM/2 benefits from a unique
  301. ongoing feedback from regular users that causes new functionality not
  302. only to appear frequently but to be tweaked to user preferences with
  303. each release.  Don't feel obligated to get each new release if you don't
  304. like updating -- keep an eye on the HISTORY.TXT and upgrade only when
  305. something you need appears.
  306.  
  307. You can always get the latest version of FM/2 from bmtmicro.com, though
  308. it makes the usual rounds fairly quickly.
  309.  
  310.  
  311.  
  312. Technical stuff:
  313. ===============
  314.  
  315. There are some limitations to FM/2, imposed by OS/2's remaining 16-bit
  316. subsystems (hopefully future versions of OS/2 will remove some or all of
  317. these -- some have already been eliminated since OS/2 2.0).
  318.  
  319. If FM/2 won't run, the probable culprit is CONFIG.SYS.  Your LIBPATH
  320. statement should contain a ".\" entry.  If yours doesn't, add it in.
  321. It's standard for an OS/2 installation, but some ill-tempered install
  322. programs accidentally knock it out.  What this does is allow a program
  323. to find and use .DLL files in the program's current directory.
  324.  
  325.  
  326. LAN troubleshooting:
  327. -------------------
  328.  
  329. FM/2 has been tested by users with the following LAN software:
  330.  
  331. LAN Server:   No known problems.
  332.  
  333. TCP/IP:       No known problems.
  334.  
  335. Novell:       Earlier versions had problems that have been corrected.
  336.               If you encounter problems, upgrade.
  337.  
  338. LANtastic:    Somewhat buggy -- contact Artisoft and ask for a fix.
  339.               They know about the problems but could use some "guidance"
  340.               from their users.
  341.  
  342.  
  343. Fixpack troubles:
  344. ----------------
  345.  
  346. Fixpack 17 for OS/2 Warp is the second buggiest fixpack in IBM history
  347. (fixpack 16 was first).  There are several bugs in FP17 that may bite
  348. you:  REXX not working right, video glitches, and focus problems are the
  349. most prevalent.  All in all, if you don't need the additional
  350. functionality of FP17 (which you probably don't, unless you're building
  351. Opendoc objects), back the fixpack off the system.  If you need one of
  352. the actual _fixes_ in the fixpack, install fixpack 10 instead (which
  353. also has its problems, but they can be overcome by backing out some
  354. files, in particular IBM1S506.ADD for many installations, and the
  355. HLP/INF viewers, which are broken).  Don't forget to reinstall any new
  356. video drivers after installing a fixpack -- they invariably put the old,
  357. buggy ones back on the system.
  358.  
  359.  
  360. Merlin notes:
  361. ============
  362.  
  363. FM/2 has been tested under the Merlin beta and works fine (as does the
  364. Merlin beta, for the most part).
  365.  
  366.  
  367.                 +----------------------------------------+
  368.                 |  IMPORTANT!  Read before distributing! |
  369.                 +----------------------------------------+
  370.  
  371. Simple license statement:
  372. ========================
  373.  
  374. You are granted a license to try this shareware program (FM/2) for up to
  375. thirty (30) days, after which you must register or discontinue its use.
  376. Permission is granted to redistribute the unaltered shareware archive
  377. for a reasonable (read nominal, small) copying charge.  FM/2 may
  378. specifically not be packaged with a commercial book without requesting
  379. and obtaining permission (common courtesy -- remember, "copyright" means
  380. literally "the right to control who copies the material").  Such
  381. permission is usually granted shortly after receipt of the request.  If
  382. you write a review on FM/2, I'd certainly appreciate a courtesy copy of
  383. the review -- my wife collects them.  All rights are reserved by the
  384. author.  That's me.
  385.  
  386. There is NO warranty.  Support is NOT guaranteed to unregistered users.
  387.  
  388.  
  389. Contact info:
  390. ============
  391.   Mark Kimes (mkimes@ibm.net; CIS 74601,1327; (318)222-3455)
  392.